home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 1 / ETO Development Tools 1.iso / Essentials / Developer Essentials Jul 90 / Apple II / Programming & Utilities / Apple IIgs APW Intro Prog Src / HP.ASM / README.txt < prev    next >
Encoding:
Text File  |  1987-09-11  |  2.6 KB  |  47 lines
  1.  
  2. *
  3. * README -- General information about the ASM65816 version of HodgePodge
  4. *
  5.  
  6. The files in this directory are the source code for the 65816 Assembly version
  7. of HodgePodge, a sample program which demonstrates many features of the Apple
  8. //GS tools.  To build the executable/launchable (type S16) load file, type
  9. "MAKE" at the prompt.  The executable file will be called "HP".
  10.  
  11. The file "MAKE" creates a custom macro file called "HP.MACROS", assembles
  12. the modules in reverse order of dependency, and then links the separate object
  13. modules using the script in the file "LINK".  Finally, the "EXE" type exe-
  14. cutable load module "HP", which is the output of the linker, is converted to
  15. the filetype "S16" so that it may be executed as a stand-alone application.
  16.  
  17. WARNING: While developing, delete the "FILETYPE HP S16" command in the "MAKE"
  18. script file.  Because HodgePodge is restartable in memory, rerunning it after
  19. a compile or assemble and link may cause an old version to be run again.  EXE -
  20. type files are always reloaded regardless of restartable status!
  21.  
  22. Throughout the program, calls are made to error checking routines (such as
  23. CheckDiskError and CheckToolError) in "DIALOG.ASM"..  Since these routines
  24. are called from many different places, they each take a "Where" integer
  25. parameter which is displayed along with the error message when an error
  26. occurs, facilitating the location of the operation which caused the error.
  27.  
  28.  
  29.  
  30. Files in this directory:
  31.  
  32. Name            Type                    Comments              Access  Subtype   
  33. README          TXT             This file                     DNBWR
  34. MAKE            SRC             EXEC file which builds HP     DNBWR   EXEC     
  35. LINK            SRC             LinkEd script file            DNBWR   LINKED   
  36. HP.ASM          SRC             Assembly main source file     DNBWR   ASM65816 
  37. EVENT.ASM       SRC             Assembly include source file  DNBWR   ASM65816 
  38. MENU.ASM        SRC             Assembly include source file  DNBWR   ASM65816 
  39. WINDOW.ASM      SRC             Assembly include source file  DNBWR   ASM65816 
  40. DIALOG.ASM      SRC             Assembly include source file  DNBWR   ASM65816 
  41. FONT.ASM        SRC             Assembly include source file  DNBWR   ASM65816 
  42. PRINT.ASM       SRC             Assembly include source file  DNBWR   ASM65816 
  43. IO.ASM          SRC             Assembly include source file  DNBWR   ASM65816 
  44. INIT.ASM        SRC             Assembly include source file  DNBWR   ASM65816 
  45. GLOBALS.ASM     SRC             Assembly include source file  DNBWR   ASM65816 
  46. HP              S16             Executable load file          DNBWR
  47.